# Emoji Picker 取扱説明書

■概要

Emoji Pickerは、Windows標準絵文字ピッカー風の操作で、
絵文字を入力するためのツールです。

Win + 無変換キーで起動し、
選択した絵文字を起動前にフォーカスしていた入力先へ入力します。

構成：

・AutoHotkey
ホットキー登録、入力制御

・Python + pywebview
絵文字ピッカー表示

・OpenMoji
絵文字画像データ（WebP形式へ最適化）

======================
■解凍時のフォルダ構成
======================

emoji┬ # Emoji Picker 取扱説明書.txt
     ├ 1st_run.bat
     ├ download_openmoji.py
     ├ emoji_launcher.ahk
     ├ emoji_picker.pyw
     ├ LICENSE
     ├ License_OpenMoji.txt
     └ Web ┬ index.html
           ├ app.js
           └ style.css

======================
■初回導入
======================

初めて使用するPCでは、
以下の準備が必要です。

導入手順：

1. Pythonインストール
https://www.python.org/downloads/

2. 1st_run.bat実行

3. emoji_launcher.ahk起動

======================
■Pythonが無い環境への導入
======================

Python未導入の場合は、先にPythonをインストールします。

■Python入手

Python公式サイトからPython 3.xを取得します。

インストール時の注意：

インストーラー最初の画面で、

「Add Python to PATH」

にチェックを入れてください。

チェック後、

Install Now

を選択します。

インストール完了後、
コマンドプロンプト(cmd.exe)を開いて確認します。

確認方法：

Windowsキー
↓
cmd と入力
↓
コマンドプロンプト起動

以下を入力します。

python --version

例：

Python 3.13.0

と表示されれば準備完了です。

======================
■1st_run.bat
======================

初回導入用バッチファイルです。

実行内容：

1. Python環境確認

2. pip更新

3. 必要ライブラリ導入

導入：pywebview, Pillow

4. 絵文字データ取得・最適化

実行：

download_openmoji.py
（OpenMojiのカラーPNGを取得し、28x28サイズのWebPへ変換して配置）

配置：

emoji┬ 1st_run.bat
     ├ download_openmoji.py
     ├ emoji_launcher.ahk
     └ emoji_picker.pyw

...

1st_run.batは、
必ずemojiフォルダ直下から実行してください。
======================
■通常起動
======================

初回導入完了後は、

emoji_launcher.ahk

を実行します。

タスクトレイにAutoHotkeyアイコンが表示されたら待機状態です。

使用：

Win + 無変換
↓
絵文字ピッカー表示
↓
絵文字選択
↓
元の入力欄へ入力

======================
■フォルダ構成
======================

emoji┬ 1st_run.bat
     ├ emoji_launcher.ahk
     ├ emoji_picker.pyw
     ├ download_openmoji.py
     ├ Cache ┬ emoji_history.json
     │       ├ group_smileys-emotion.json（※各パレットを開くと自動生成）
     │       └ ... (各カテゴリ別キャッシュ)
     │
     ├ Data ┬ emoji_list.txt
     │      └ webp/
     │      
     └ Web ┬ index.html
           ├ app.js
           └ style.css

■生成されるファイル

以下は自動生成されます。

emoji_result.txt

選択した絵文字受け渡し用

emoji_cancel.txt

キャンセル通知用

Cache/emoji_history.json

Recent履歴保存用

Cache/group_*.json

各カテゴリごとの表示用キャッシュデータ（自動オンデマンド生成）

======================
■操作方法
======================

キーボード：

矢印キー

絵文字移動

Enter

選択中の絵文字入力

Tab または 中クリック

カテゴリとパレット切替

左右キー

カテゴリ移動

W / S

ページ移動

Esc

ピッカーを閉じる

マウス：

クリック / ダブルクリック

選択

中クリック（ホイールボタン）

カテゴリタブとパレット部分のフォーカス相互切り替え

======================
■Recent履歴
======================

入力した絵文字はRecentカテゴリへ保存されます。

最大保存数：20件

同じ絵文字を再入力すると、
履歴先頭へ移動します。

======================
■ファイル役割
======================

1st_run.bat
・初回環境構築用

emoji_launcher.ahk
・Win + 無変換登録
・ピッカー起動
・選択文字貼り付け

emoji_picker.pyw
・画面表示
・オンデマンド・キャッシュ管理
・履歴管理
・結果出力

download_openmoji.py
・カラー絵文字データ（PNG）取得
・28x28サイズへのリサイズおよびWebP変換

Web/
・UI表示
・操作処理

Data/
・emoji_list.txt（絵文字一覧データ）
・webp/（WebP画像データ）

Cache/
・カテゴリ別キャッシュデータ
・履歴データ

======================
■トラブル対処
======================
■ピッカーが起動しない

確認：

・emoji_picker.pywが存在するか

・Pythonが動作するか

・pywebview、Pillowが導入済みか

■絵文字が表示されない

確認：

Data/webp/
Cache/

必要なら：

1st_run.bat

を再実行してください。

■絵文字が入力されない

確認：

・入力先が文字入力可能か

・クリップボード制限がないか

======================
■終了方法
======================

AutoHotkeyは常駐します。

終了：タスクトレイのAutoHotkeyアイコン右クリック
               ↓
             Exit

======================
■ライセンス
======================

本ソフトウェアは以下の外部ソフトウェアおよびデータを利用しています。
◆OpenMoji

本ソフトウェアに含まれる絵文字画像データは、 OpenMojiプロジェクトのデータを使用しています。

OpenMoji License:

Creative Commons Attribution-ShareAlike 4.0 International
(CC BY-SA 4.0)

https://creativecommons.org/licenses/by-sa/4.0/
Copyright:
OpenMoji Team

OpenMoji:
https://openmoji.org/ 

利用しているOpenMojiの画像データは、 CC BY-SA 4.0の条件に従って利用・改変・再配布してください。



◆Emoji Picker

本ソフトウェアのOpenMoji以外の部分
(.ahk、.py、.pyw、.js...etc.)

Copyright (C) 2026 Anonymous

License = MIT License
======================